Ir para o conteúdo principal

Obtenha uma lista de todos os modelos

O endpoint é usado para obter uma lista de todos os modelos do sistema, incluindo modelos de vídeo, carrossel, imagem, cotações e memes. Este é um endpoint paginado e, portanto, você receberá uma resposta paginada.

URL de solicitação​

  • ENTRE https://brain.predis.ai/predis_api/v1/get_templates/

Solicitar Parâmetros​

NomeDescriçãoFormatoValor padrãoValores PossíveisExigido
brand_idO brand_id serve como identificador exclusivo da sua marca. Usando o brand_id, você também terá acesso aos seus modelos personalizados na primeira página.TangaNoneYOUR_BRAND_IDSim
media_typePara obter modelos de um tipo de mídia específico.Tangasingle_imagesingle_image, carousel, videoNão
post_typePara obter modelos de um tipo específico de postagem. Para meme e quotes postar media_type deveria estar single_image.Tangagenericgeneric, meme, quotesNão
aspect_ratioPara obter modelos de uma proporção específica.Tangaallsquare, portrait, landscape, allNão
page_nIndique o número da página para recuperar modelos dessa página específica.Número inteiro11, 2, 3...etcNão
items_nIndique o número desejado de modelos para cada página.Número inteiro101, 2, 3...etcNão

Exemplo de resposta de sucesso​

{
"templates": [{
"template_id": "...",
"media_type": "..."
}],
"total_pages": 50,
"errors": []
}

Exemplo de resposta de erro​

{
"errors": [{
"detail": "...",
"solution": "..."
}]
}

Códigos de Resposta​

Código de status HTTPErro de códigoMensagem do usuárioSolução recomendada
429001Número máximo de solicitações atingidoNúmero máximo de solicitações por hora atingido Você foi limitado pela taxa. Aguarde um pouco e tente novamente
400002Inválido brand_id fornecidoVocê forneceu um inválido brand_id. Forneça um documento válido brand_id e tente novamente. Leia mais aqui.
400003Os números de página do número de itens são inválidosCertifique-se de que o valor de page_n e items_n é inteiro
400004Fornecido aspect_ratio não é suportadoCertifique-se de que o valor de aspect_ratio campo é suportado. Verifique os parâmetros de solicitação na tabela acima para obter mais detalhes
400005O valor fornecido para o media_type campo não é válidoCertifique-se de que o valor seja um dos single_image, carousel or video
400006O valor fornecido para o video_duration campo não é válidoCertifique-se de que o valor seja short or long
400007O valor fornecido para o post_type campo não é válidoCertifique-se de que o valor seja generic, meme or quotes
400008O valor fornecido para o post_type campo não é válido para o dado media_typeO fornecido post_type e media_type combinação de postagem ainda não é suportada. Verifique os parâmetros de solicitação na tabela acima para obter mais detalhes

Limitação de taxa​

Padrão API limites de taxa se aplicam a este ponto final. Leia mais sobre os limites de taxa aqui.